home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / mail / maildb10.zip / MAILDB.DOC < prev    next >
Text File  |  1992-12-22  |  44KB  |  965 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                          
  7.                      ╔╗  ╔╗                   ╔══╗   ╔═╗
  8.                      ║╚╗╔╝║  ╔═══╗  ═╦═  ╦    ║  ╚╗  ║ ╚╗
  9.                      ║ ╚╝ ║  ║   ║   ║   ║    ║   ║  ║ ╔╝
  10.                      ║    ║  ╠═══╣   ║   ║    ║   ║  ╠═╣
  11.                      ║    ║  ║   ║   ║   ║    ║   ║  ║ ╚╗
  12.                      ║    ║  ║   ║   ║   ║    ║  ╔╝  ║ ╔╝
  13.                      ╩    ╩  ╩   ╩  ═╩═  ╚═══ ╚══╝   ╚═╝  
  14.                                     
  15.                   MailDB 1.0α(C) by Carlos Gonçalves Batista
  16.                 
  17.            
  18.                  QWKConverted Data Base and TXT2REP and REP2TXT
  19.                         To use with IBM PC and compatibles
  20.               
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33. ----------------------------------------------------------------------------
  34.  
  35. Index:
  36. ══════
  37.  
  38. 01 - Disclameirs and software licence
  39. 02 - Why MailDB?
  40. 03 - Thanks
  41. 04 - Support BBS's 
  42. 05 - How to register?         
  43. 06 - MailDB basic concepts
  44. 07 - Configuracion(MAILDB.CFG)
  45. 08 - Getting MailDB started
  46. 09 - Guide to MailDB's Menu System
  47. 10 - TWIT-Lists and CFG's                
  48. 11 - Line Opcions(TXT2REP and REP2TXT)
  49. 12 - MailDB Log's file(MAILDB.LOG)
  50. 13 - DOS ErrorLevels
  51. 14 - Windows 3.1 and MailDB
  52. 15 - Tips and Advices
  53. 16 - Historics                                
  54. 17 - MailDB's Future 
  55. 18 - Acknowlodgments
  56.  
  57. ----------------------------------------------------------------------------
  58.  
  59. 01- Disclameirs and software licence:
  60. ═════════════════════════════════════ 
  61.  
  62.  ■ This program and all is documentation is Copyright of Carlos Miguel Salas
  63.    Gonçalves Batista. All Rights Reserved.
  64.    
  65.  ■ The author specifically disclaims all warranties, expressed or implied,
  66.    including but not limited to implied warranties of merchantability and
  67.    fitness for a particular purpose and MailDB license granted herein in
  68.    particular, and without limiting operation of MailDB gram license with
  69.    respect to any particular application, use, or purpose. In no event shall
  70.    the author be liable for any loss of profit, lost savings, commercial
  71.    damage, or other incidental or consequential damages arising out of the use
  72.    or inability  to use MailDB  even if  the  author, Carlos Batista, or an
  73.    authorized distributor of MailDB has been advised of the possibility of
  74.    such damages, or for any claim by any other party.
  75.  
  76.  ■ You can freely distribute MailDB if and only if these three conditions are
  77.    satisfied:
  78.    ≡ MailDB file and accompaning materials(documentation) must be all together
  79.    ≡ MailDB and its documentation must not be altered in any form
  80.    ≡ You cannot charge any special fee for distributing MailDB, except for
  81.      cover your own distribution costs
  82.  
  83.  ■ Distributors of Shareware and Public Domain software MUST obtain written
  84.    permission from Carlos Batista before distributing MailDB and must follow
  85.    the above conditions. Permission is almost always granted.
  86.  
  87.  ■ This software cannot be used for the devolpment of other projects, and it
  88.    cannot be included by any means in any other software or software package.
  89.  
  90.  ■ The files that MailDB produces, this is the module files; with the .MIQ, 
  91.    .MIL, .HFS, .CBS extensions are interely yours to do what you want with 
  92.    them at your responsability and charge. If you used them in any other 
  93.    software that implies the divulgation of that files, you must give the 
  94.    credits to MailDB on the documentation or on the program itself.
  95.  
  96.  ■ Bulletin Board system operators may post MailDB on their BBS for
  97.    downloading by their users without written permission, only if no special 
  98.    fee is necessary to access MailDB files (a general fee to access the BBS 
  99.    is acceptable).
  100.  
  101. -----------------------------------------------------------------------------
  102.  
  103. 02- Why MailDB?
  104. ═══════════════
  105.  
  106.  ■ The thing that made me programming MailDB, was the need of a program of 
  107.    this kind in the Shareware market.
  108.    There are a lot of good(and bad...) MailReaders, a lot of MailReaders with
  109.    DataBase from messages. But no program that generate and manage a Data Base
  110.    independent of the MailReader.
  111.  
  112.  ■ At last OLX(tm)/SLMR(tm)/KingQWK(tm)/Blue Wave(tm)/Jabber(tm) users can 
  113.    have a Data Base of messages without leaving is favourit mail-reader!
  114.  
  115.  ■ Its obvious that the MailDB is a complement to a a Mail Reader like OLX
  116.    or SLMR. And this is because the MailDB only keeps a Data Base of messages
  117.    (and believe me, it's not ONLY that!!! :) ) that is exactly what OLX and 
  118.    SLMR don't do!
  119.  
  120.  ■ As so, the MailDB was designed so it can work in the reader directory, and
  121.    be as organized as ever!
  122.  
  123.  ■ Let's see now some of the reasons to use(and register!) MailDB:
  124.    ≡ Data Base of normal ASCII files created from normal .QWK format files
  125.    ≡ Total conversion of one .QWK or of only one message, or only of one 
  126.      conference, etc...
  127.    ≡ Configuration files to optimize certain operations  
  128.    ≡ Backup/Restore of a module
  129.    ≡ String consult(case sensitive)     
  130.    ≡ General consult of all messages in the module
  131.    ≡ List of messages inside the module in use            
  132.    ≡ See a determined message 
  133.    ≡ Possibility of giving commands when consulting a message
  134.    ≡ Export a message from the module to a normal, readable text file
  135.    ≡ Exclusion list on the following QWK fileds; FROM, SUBJECT and
  136.      CONFERENCE. Possibility of including that exclusions on a CFG to 
  137.      automatizate the process
  138.    ≡ Execute a DOS command 
  139.    ≡ DOS Shell
  140.    ≡ NDOS, 4DOS, etc... support in shelling operations
  141.    ≡ Color Pull-down menus
  142.    ≡ TXT2REP, this is a conversion of a normal text file to a .REP file format
  143.      ready to be sent to a BBS. With a Tagline with the user name(registered
  144.      versions only).
  145.      If the file is to big to fit into a single messages, it will be 'cut' 
  146.      into several messages. If te file BBS_ID.REP already exists, new messages 
  147.      will be appended to it.
  148.    ≡ REP2TXT, to those who want to keep they replies in a normal text file.
  149.    ≡ Support to the major compacters of the market(ARJ, ZIP, LHA, ARC)
  150.    ≡ Automatic descompression of the .QWK and of the .REP
  151.    ≡ Automatic compression of the .REP (on TXT2REP)
  152.    ≡ On-Line description of all opcions in the menu system
  153.    ≡ Information about the .MIQ (size, number of messages, etc...) inside the 
  154.      menu system.
  155.  
  156.  ■ Having a Data Base of messages is so essencial as reading it.
  157.    How many times didn't you need to convert a file to REP format and had to
  158.    type it? How many times did you need to confirm a quote? How many times
  159.    did you need to see a anciente message of a theme that you need now?
  160.    How many QWK do you have stored? When will you be able to finally keep
  161.    a Data Base of your mail?
  162.    The answer is NOW! With MailDB 1.0α
  163.  
  164. ------------------------------------------------------------------------------
  165.  
  166. 03- Thanks:
  167. ═══════════
  168.  
  169.  ■ To all those who back-me-up and helped me making this programa my sincere
  170.    thanks. Some of them were my ßeta Testers(marked with (ß)):
  171.      
  172.    - Afonso Vicente(ß)
  173.    - Carlos Santos(ß)
  174.    - Duarte Oliveira(ß)
  175.    - Fernando Madruga(ß), Author of the copy rotine that integrates MailDB
  176.    - Joäo Cabral(ß), for all the technic help in all fases of the project
  177.    - Jaime Amaral(ß)
  178.    - Pedro Rosa(ß), Blaster BBS SysOp.
  179.    - Sérgio Duarte(ß)
  180.    
  181.  ■ And a very, very special thanks to my brother; Vitor Salas Baptista
  182.  
  183.  ■ To Eduardo Oliveira, also Blaster BBS SysOp
  184.  
  185.  ■ To Mario Pozzetti, SysOp of SkyShip BBS
  186.  
  187.  ■ I wish to thank also the FREENET conference users for all the support in
  188.    the program last fase in particular to Luis Bita.
  189.  
  190.  ■ To the mysterious author of the QWKINFO.ZIP file
  191.  
  192.  ■ To Borland Int. for the excelent Turbo C 2.0
  193.  
  194.  ■ To Mark 'Sparky' Herring the author of QWK Format.
  195.  
  196.  ■ To PKWare for the excellent PKLITE.
  197.  
  198. ------------------------------------------------------------------------------
  199.  
  200. 04- Support BBS's and how to contact the author:
  201. ════════════════════════════════════════════════ 
  202.  
  203.  ■ The MailDB as a project and I as a the programmer, have the special 
  204.    support of two BBS; Blaster BBS and SkyShip BBS.
  205.    In both of them exists a PRIVATE SUPPORT CONFERENCE for those users
  206.    that register and is there that I make the support to them.
  207.  
  208.  ■ Blaster BBS, is a Public Bulletin Board System dedicated to the 
  209.    Multimedia and Sound Support. Is number is: 
  210.            
  211.     Node 1: 351-1-3878640 * 24H * 2400 to 14400K
  212.  
  213.  ■ SkyShip is a Public BBS with general interest, is numbers are:
  214.            
  215.     Node 1: 351-1-3527623 * 24H * 2400 to 14400K MNP only
  216.     Node 2: 351-1-3151435 * 24H * 1200 to 14400K
  217.     Node 3: 351-1-3151436 * 24H * 1200 to 14400K
  218.  
  219.  ■ If by any reason you need to contact me, you can do it by two ways:
  220.     1st: Leaving a message to CARLOS BATISTA in Blaster BBS or SkyShip BBS
  221.          Main Board's Conferences.
  222.     2nd: Writing a letter to the following adress
  223.          Carlos Batista - MailDB Project
  224.          Av. Aviaçäo Portuguesa, 23 - 1ºDrt
  225.          2700 Amadora
  226.          Portugal
  227.  
  228. ------------------------------------------------------------------------------
  229.  
  230. 05- How to register?:
  231. ═════════════════════
  232.  
  233.  ■ MailDB is a program issued under the Shareware concept. This implies
  234.    a simply honor agreement : "Use first, pay latter".
  235.    What I mean is that; I the programmer, give you the user, a 15 days trial
  236.    period, in wich you are free to use the programa without any limitation.
  237.    After that period and if you continue to use the program, you must pay a
  238.    register fee. 
  239.    (MailDB is not CrippleWare, as so, the program is full functional in the
  240.    ShareWare version)
  241.  
  242.  ■ The user that register MailDB will have the following advantages:
  243.   
  244.    ≡ The registered user will not have to wait 3 seconds on the program start 
  245.      and the exit messsage will also disappear.
  246.  
  247.    ≡ For the user that registers with is usual login name (acess BBS's name) 
  248.      on the conversion of QWK can check how many messages are destined to him
  249.  
  250.    ≡ It will be given acess to the TWO MailDB PRIVATE SUPPORT CONFERENCE
  251.      (on Blaster BBS and on SkyShip BBS), for register users only, and in 
  252.      that conferences you will get a every day help. 
  253.      In there you may also find files relating MailDB to Download freely(only
  254.      paying the connection, obvsiouly.)
  255.  
  256.    ≡ The register user will have acess to a register number to work with is
  257.      register expression, that will alow you, within other things to;
  258.      Have your name on the messages converted by the TXT2REP function, having 
  259.      your personal ID in all MIQ's, removal of the exit screen, etc...
  260.  
  261.    ≡ To those who register, it will be delivered at home a printed copy of 
  262.      this manual.
  263.  
  264.    ≡ To the register user I guarantee that this register fee and register 
  265.      number will be suited for all future versions.
  266.  
  267.    ≡ It's only with your support that other excellent programs like MailDB
  268.      can be available at such low prices.
  269.  
  270.  ■ To the user who register MaiLDB will be asked a register expression,
  271.    that expression cannot be bigger than 20 caracters and preferebly must be
  272.    a personal name or a business name.
  273.    Expressions like: 1111, oasoas, Me, etc. are not accepted.
  274.    In no circunstance can be two equal register expressions.
  275.   
  276.  ■ The price is the following (Shipping and Handling included):
  277.     - 1500$00 Portuguese Escudos if you are inside Portugal
  278.     - £7 English Pounds if you are in a European Comunity Country
  279.     - $12 American Dolars(or equivalent) to the rest of the world.
  280.  
  281.  ■ There are two ways to register MailDB, that are the following:
  282.   
  283.    ≡ Filling the file REGISTER.TXT:
  284.      Send the filled file and the money to:
  285.        
  286.            Carlos Batista - SoftWare Dvl.
  287.            Av. Aviaçäo Portuguesa, 23 - 1º Drt
  288.            2700 Amadora 
  289.            Portugal
  290.  
  291.    ≡ Connect to SkyShip BBS on Lisbon, Portugal and fill the 
  292.      script(questionaire) number one. And send the money to the
  293.      adress given above. This possibility is for those that by any chance
  294.      have 'lost' the REGISTER.TXT file. The Skyship number is 
  295.      on point 04 of the manual.
  296.  
  297.  ■ All checks and postal orders must be in the name of Carlos Miguel 
  298.    Salas Gonçalves Batista.
  299.  
  300.  ■ Please give me a 15 days period to arrange all the register user benefits
  301.  
  302. ------------------------------------------------------------------------------
  303.  
  304. 06- Basic MailDB concepts and requisitions:
  305. ═══════════════════════════════════════════
  306.  
  307.  ■ Before anythig else here's a little description of some terms used so far
  308.    - .MIQ, .MIL, .HFS, .CBS are the extensions used by MailDBe and is purpose
  309.      is to more efectivily manage a modeule. The file name of the files with 
  310.      thies extensions is the modeule name that you choose when execute MailDB
  311.      Those extensions names mean:
  312.      ≡ .MIQ: Name that came form previous messages and in direct traslation 
  313.              means Merge It(first name of MailDB) QWK. Is the files that 
  314.              contains the messages.
  315.      ≡ .MIL: The same as .MIQ; Merge It List. The file were the message list 
  316.              is.
  317.      ≡ .HFS: Header and File Size, is the index file for the module
  318.      ≡ .CBS: Connect Beetweem Sessions, to make the connection beetween a 
  319.              a MailDB session and another.
  320.  
  321.    - Module: I refer as module as the group of all those four files with 
  322.      those extensions an with the same name, that is the name that you give 
  323.      when execute MailDB.
  324.    - 'Msg' and 'Msgs' are the same as E-mail Message.
  325.  
  326.  ■ MailDB only works with the MESSAGES.DAT and CONTROL.DAT files existing in
  327.    the .QWK file format. MailDB DOESN'T alter the .QWK! It only reads those
  328.    two files and that is all he needs from the QWK.
  329.  
  330.  ■ You need the following to work with MailDB on your PC:
  331.    - A IBM PC, XT, AT, i386, i486 or PS/2, or compatible
  332.    - Will need a operating system equal or superior to MS-DOS 3.3 or 
  333.      compatible. 
  334.    - You need at least 111 Kb of free conventional memory to run MailDB. 
  335.    
  336. ------------------------------------------------------------------------------
  337.  
  338. 07- Configuracion(MAILDB.CFG):
  339. ══════════════════════════════
  340.  
  341.  ■ MailDB is configurated from a normal ASCII file, without any special 
  342.    formats(like WordStar or Display Write). And be editable on a normal
  343.    editor like EDIT that came with MS-DOS 5.0
  344.  
  345.  ■ The file MUST be called MAILDB.CFG and it must be on the same directory as
  346.    MAILDB.EXE, on other way it will not run.
  347.  
  348.  ■ To configure MailDB to your system edit the file MAILDB.CFG that came in 
  349.    the MAILDB10.ZIP file and edit the following lines keeping in mind the 
  350.    description of each one given here:
  351.  
  352.    1st Line ........... C:\MODEM\DOWN\ 
  353.  
  354.                          In this line is the path to the directory where the
  355.                          .QWK are. It's normally the same directory that 
  356.                          receives the files that you download from the BBS's
  357.                          It must terminate with a backslash - '\'.
  358.  
  359.    2nd Line ........... C:\MODEM\UP\
  360.  
  361.                          In this line it is the .REP path.
  362.                          It's normally the directory where you put the files
  363.                          that you want to upload to a BBS.
  364.                          It has, also, to terminate with a backslash: '\'.
  365.  
  366.    3rd Line ........... ZIP
  367.  
  368.                          This is the line were you indicate to the program of 
  369.                          what compressor you use in the QWk and REP files.
  370.                          You'll write a three letter word that is the extension
  371.                          that is associeated with the compacters.
  372.                          The codes are the following:
  373.                          
  374.                               Identifier:               Respective compacter:
  375.                                  ZIP                        PKZIP/PKUNZIP
  376.                                  ARJ                            ARJ
  377.                                  LZH                            LHA
  378.                                  ARC                        PKARC/PKUNARC
  379.  
  380.                          All this programs must be found in the DOS path 
  381.                          And they must also have the name refered backwards 
  382.                          this is: PKZIP/PKUNZIP, ARJ, LHA, PKARC/PKUNARC.
  383.                          And this is a priority! Without this steps followed
  384.                          attentionsly you cannot run effectively the program
  385.     
  386.    4th Line ........... UNREGISTERED≡0≡
  387.  
  388.                          The 4th line is used for the register process.
  389.                          This line is very special: You'll have to separate
  390.                          the name form the number by a ≡ (ASCII #240) and
  391.                          you'll have to end the line with that same caracter.
  392.                          This is, the format is: nome_de_registo≡numero≡
  393.                          
  394.                          If you are not registered in the place of the name 
  395.                          you must put 'UNREGISTERED' and in the place of the
  396.                          number you must put '0'. Like this : UNREFGISTERED≡0≡
  397.  
  398.  ■ The MAILDB.CFG design and the reading routine were designed so the even
  399.    most inexperient user could easily configurate MailDB, but;
  400.   
  401.  ■ If you have any doubt please contact me by one of the ways of the point
  402.    four of the manual.
  403.  
  404. ------------------------------------------------------------------------------
  405.  
  406. 08- Getting MailDB Started:
  407. ═══════════════════════════
  408.  
  409.  ■ There are three possible ways to execute MailDB and they are all three
  410.    described in the next two points of the manual.
  411.  
  412.  ■ Please don not try to run MAILDB.EXE without MAILDB.CFG on the same 
  413.    directory, the program won't let you do so.
  414.  
  415.  ■ If you want to enter MailDB Data Base Menu you must do the following
  416.    on the command line; 
  417.    C:\MAILDB\MAILDB FILENAME
  418.  
  419.    This is; Execute MailDB file giving as argument a filename and 
  420.    only a valid DOS filename without extension or path!
  421.  
  422.  ■ To acess the two line opcions read carefully point 11 of the manual were
  423.    there acess is explained.
  424.  
  425.  ■ To see the line format on the various opcions and also to see some 
  426.    examples of them call MAILDB on the command line WITHOU any argument.
  427.  
  428.  ■ If you have any doubts fell free to contact me.
  429.  
  430. ------------------------------------------------------------------------------
  431.  
  432. 09- Guide to MailDB Menu System:
  433. ════════════════════════════════
  434.  
  435.  ■ The menu system(menu for now on), is destined to the management of the 
  436.    Data Base. The menus are Windows(tm)-type, this is if any sub-opcion 
  437.    exists they will appear under the principal opcion seleccioned. And the 
  438.    windows are exploing-one type, with a little shaddow.
  439.  
  440.  ■ To aces the menu system; execute the program and give him as a opcion
  441.    a file name that will be the identifier of the module that you will use.
  442.    The file name must be in the DOS limitations for a file name, this is
  443.    8 characters maximum and CANNOT include some special characters: '.' or 
  444.    '\'.
  445.    This argument CANNOT be a path like C:\UTILS\FICHEIRO.EXT or have an 
  446.    extension appended to it. Only a 8-character-maximum file name like:
  447.    C:\MAILDB\MAILDB FILENAME
  448.    D:\MAILDB BLASTER
  449.  
  450.  ■ The control keys for the menu system are:
  451.    - Left Cursor: Move the highlighted opcion to the left
  452.    - Right Cursora: Move the highlighted opcion to the right
  453.    - TAB: Same as Left Cursor
  454.    - Home: Move the highlighted opcion to the first opcion
  455.    - End: Move the highlighted opcion to the last opcion.
  456.    - ESC: Iniciate exit sequence
  457.    - ENTER or Carriage Return: Choose a opcion or sub-opcion
  458.    - F1: It will appear on the screen a copyright notice and a register
  459.      user information
  460.    - F2: Informative screen, with informations regarding module size,
  461.      number of messages stored in module, etc...
  462.    
  463.    The principal menu contains very imporatant informations about the module
  464.    in use. Let's see them:
  465.  
  466.     ┌────────────────────────────────────────────────────────────┐
  467.     │                   (opcions)                                │-> principal
  468.     ├────────────────────────────────────────────────────────────┤   opcions  
  469.     │                                                            │
  470.     │                                                            │
  471.     │                                                            │
  472.     │                                                            │
  473.     │                                                            │
  474.     ├─────────────────────────────┬──────────────┬───────────────┤
  475.     │ (description)               │* TEST.MIQ    │ MailDB 1.0α   │
  476.     └─────────────────────────────┴──────────────┴───────────────┘
  477.         │                              │
  478.         └> Opcion or sub-opcion        └> The name of the mudule in use
  479.            that is highlighted.           If this module was already created
  480.                                           and contains messages a '*' will
  481.                                           appear before the name
  482.  
  483.  ■ Using teh keys described before you can easily manage MailDB DataBase
  484.    Feature. With them you can choose a opcion or sub-opcion to execute.
  485.    The available opcions(and sub-opcions) are:
  486.  
  487.    ≡ QWK: This opcion is destiny to put one more QWK packet inside the 
  488.      module. After pressing <CR> it will be asked the name of the QWK to be 
  489.      converted. If you have a file that is on QWK format but is extension is
  490.      not .QWK you are free to put the extension you want, but if you 
  491.      introduce only the name, MailDB assumes that .QWK is the extension.
  492.  
  493.      After that and if the packet really exists, it will be asked a comment
  494.      (opcional) that will be written in MAILDB.LOG. For example if you want
  495.      to put a comment saying - "The modem configuration is here." It will be
  496.      much more easy to know in each module it's in a consultation .
  497.      After that and if doesn't exist a CFG(see point 9 on manual) with the 
  498.      name of the BBS it will be asked to you the excepcions to be made on 
  499.      the convertion.
  500.  
  501.    ≡ PARCIAL: Here you'll have the chance to convert only a part of the QWK.
  502.      The major difference beetween QWK and PARCIAL opcions is that in 
  503.      PARCIAL you must say what messages with determined field-caracteristics 
  504.      are to be converted. And how? REsponding to some questions that will 
  505.      appear to you.
  506.      For example if on the first question:
  507.      "TO name to convert?" if you introduce CARLOS BATISTA, MailDB will only 
  508.      convert the messages TO CARLOS BATISTA.
  509.      On the second; "FROM name to convert?" if you introduce VITOR SALAS 
  510.      MailDB will only convert the messages that came from VITOR SALAS.
  511.      The last question; "CONFERENCE number to convert?" If you put 0 MailDB 
  512.      will only convert messages form 0 conference.
  513.        
  514.      You can answer all three questions, and if you do that the messages
  515.      (following the previous example) TO CARLOS BATISTA, FROM VITOR SALAS 
  516.      and from conference 0 will be converted.
  517.  
  518.      If you put all three answer in blank none message will be converted.
  519.      
  520.    ≡ BACKUP: Here you can make a backup or restore of a module. 
  521.      You can in this sub-menu restore the files backed-up with BACKUP command
  522.      with the RESTORE command. To do it just choose the sub-opcion RESTORE.
  523.      The .MIB file has inside the 4 files that 'are' the module in use, and
  524.      they are compacted by the compacter choosen on MAILDB.CFG, as simple as
  525.      that! So if you have any trouble on restoring the MIB file check if you
  526.      change the compacter on MAILDB.CFG.
  527.  
  528.      You can also copie the MIB file to a diskette, keeping the module in a
  529.      safe place, for a future consult.
  530.  
  531.      The restore sub-opcion makes a restore of the .MIB file that is on
  532.      the ...\MIQ directory! So of you want to restore some module you better 
  533.      put it on the ..\MIQ diretory first.    
  534.  
  535.      ATTENTION: When you make a restore you'll delete the module that exists 
  536.      with the same name! But when a sitution like that accurs a confirmation 
  537.      question will be asked.
  538.  
  539.    ≡ CONSULT: The must complete menu on MailDB, it allows you to make four
  540.      kinds of consultations/views to the module in use.
  541.      When you press <CR> it will be shown to you a menu with four sub 
  542.      opcions described below:
  543.        
  544.       φ GENERAL: It will be shown to you all the .MIQ, message to message.
  545.         You'll be able to give commands when a message is at his end, you
  546.         can enter three differente commands:
  547.         (N)ext - If you press the 'N' or 'n' key a next message on MIQ will
  548.                  be shown
  549.         (B)ack - If you press the 'B' or 'b' key the previous message will
  550.                  be shown.
  551.         (F)ile - With this opcion you are able to export the message(and only
  552.                  that message, to a DOS file.
  553.                  If that file already exists the new message will be appended
  554.                  to it.
  555.         (T)his - To re-read the smae message.
  556.         (E)nd  - Exit general consultation and go back to main menu.
  557.  
  558.       φ STRING: It searchs a string(sequence of ASCII characters)
  559.         to the maximum of 18 characters. When it founds the string
  560.         it shows the message(s) where that string is.
  561.         The string consult is case sensitive, this is the word 'ola' e 'OLA' 
  562.         are differents!
  563.         The commands that you can give here are:
  564.         (C)ontinue - To continue string search
  565.         (F)ile     - To export to a DOS file that message
  566.                      If that file already exists the new message will be 
  567.                      appended to it.
  568.         (E)nd      - To end string consult and return to main menu.
  569.  
  570.       φ LIST: Here MailDB will show the list of the messages that are inside
  571.         of the module in use. It describies it using the following fields 
  572.         FROM, TO, SUBJECT, CONFERENCE, NUMBER.
  573.         The commands that you can give here are:
  574.         (E)nd      - Finish list
  575.         (C)ontine  - Go to next page
  576.         (S)ee      - See a determined message, after you choose the message
  577.                      you wanna see, the commands are the same as on determined
  578.                      message consult/general consult.
  579.                      If you want to go back to consult list of messages you
  580.                      musr re-select it.
  581.       
  582.       φ RIGHT: With this sub-opcion you can consult a determined message
  583.         on the module. You can go directly to that message without reading 
  584.         them all. 
  585.         The commands are the same as on GENERAL consult.
  586.        
  587.    ≡ EXEC: This opcion is made toexecute a single DOS command. The directory
  588.      of start is the ..\MIQ
  589.      Finishing executing the command MailDB returns to the start directory.
  590.      You can use this opcion to EDIT .MIQ with a normal editor or to view it
  591.      with for example Vernon Buerger's LIST.COM, etc...
  592.  
  593.    ≡ UTILS: Two utilities to manage the modules:
  594.      
  595.       φ PRINT: To print the .MIQ file, this is the file with the messages 
  596.         converted.
  597.         What he does is to send the file to the DOS port known as PRN. As so
  598.         having the printer configurated in DOS will have the printer 
  599.         configurated on MailDB.
  600.         I advise the utilization of continued paper, due to the dimension of
  601.         certain MIQ's may have.
  602.  
  603.       φ CHANGE: To change the module in use without exiting MailDB. This will
  604.         make MailDB change the current module to the one that you indicated.
  605.         When answering; ENTER alone will make a abort of that command.
  606.  
  607.    ≡ DELETE: To delete or the module or the backup file(MIB). It will ask
  608.      for confirmation.
  609.      
  610.    ≡ SHELL AO DOS: Makes a well known DOS Shell. To return to MailDB execute
  611.      the command 'exit' on the DOS prompt.
  612.      If you ahve other command line interpreter different of COMMAND.COM 
  613.      don't worry MailDB will Shell knowing that.
  614.      ou can freely change diretory when in a Shell, because MailDB don't 
  615.      worry about that... :)
  616.  
  617. ------------------------------------------------------------------------------
  618.  
  619. 10- TWIT list's and exclusions:
  620. ═══════════════════════════════
  621.  
  622.  ■ MailDB has a characteristic that allows to exclude certain messages of
  623.    being converted/included in the module.
  624.  
  625.  ■ As so you can exclude messages from being converted by its FROM name, 
  626.    CONFERENCE number or SUBJECT.
  627.  
  628.  ■ There are two ways of making that exclusion; Trought a file with the 
  629.    extension .CFG and with the name being the BBS_ID, this is the name of
  630.    the QWK that you download form the BBS, or you can also exclude by the
  631.    answer of some questions.
  632.  
  633.  ■ Those files CFG msut be on a directory above MAILDB's EXE and CFG file
  634.    And that directory must have the CFG name.
  635.    Ex: C:\MODEM\MAILDB     -> Diretory where MAILDb.EXE and MAILDB.CFG are.
  636.        C:\MODEM\MAILDB\CFG -> Directory where the CFG's must be.
  637.  
  638.  ■ That file is a normal text filem editable in any normal text editor and
  639.    with the following chracteristics:
  640.    
  641.    ≡ On the first line is the SUBJECT to exclude:
  642.      Ex: HOLLYDAYS
  643.    ≡ On the second line there is the CONFERENCE NUMBER to be eliminated:
  644.      Ex: 10
  645.    ≡ On the third line there is the FROM name to exclude:
  646.      Ex: JOAO CABRAL
  647.  
  648.  ■ When you want to exclude only two(or one or zero!) fields put a blank line 
  649.    (no characters at all!!!) on the place where the exclusion(s) field(s).
  650.  
  651.  ■ ATTENTION: MailDB, in this version, can only exclude ONE FROM, ONE TO and
  652.    ONE CONFERENCE, this is, you can't exclude conference number 1 and 2, only
  653.    1 or only 2...
  654.  
  655.  ■ ATTENTION: In any way the CFG must ALLWAYS have three lines! If this 
  656.    doesn't happen it's must likely that the program will stop dragging with 
  657.    him the operating system.
  658.  
  659.  ■ The other way to exclude is to answer three wuestions that will appear    
  660.    when you are about to convert/include the messages to/in the module.
  661.  
  662.    NOTE: The questions only appear if a CFG with a name of that BBS doesn't
  663.          exist.
  664.  
  665. ------------------------------------------------------------------------------
  666.  
  667. 11- Line Opcions:
  668. ═════════════════
  669.  
  670.  ■ MailDB has two line options, that I consider very usefull.
  671.  
  672.  ■ Those line functions are destined to include the REP in the MailDB program
  673.    Once the Data Base was designed only for QWK the REP have in the line
  674.    functions a special attention.
  675.  
  676.  ■ The opcion TXT2REP allows to send a normal text file(like AUTOEXE.BAT or
  677.    CONFIG.SYS) to the message area of a BBS using a normal REP file.
  678.    What MailDB does is convert the text file in to a REP packet all ready to
  679.    sent to the BBS.
  680.    If the text file is too big to fit in to a single message, MailDB cuts it
  681.    into several messages.
  682.    If already exits a REP file MailDB will append the new message(s) to that 
  683.    REP file.
  684.   
  685.  ■ But the other command line opcion is the REP2TXT and is objectiv is to 
  686.    convert the files with our replys - The .REP's -, from their "strange" 
  687.    format to a normal text file.
  688.     - It's sintax is:                    
  689.       
  690.       MAILDB /C BBS_ID TXTDEST
  691.          ^    ^    ^      ^
  692.          │    │    │      │
  693.          │    │    │      └ Text file to be created with the contents of REP
  694.          │    │    └ REP name(without path and without extension)
  695.          │    └ Command that defines that the opcion REP2TXT is to be executed
  696.          └ Programa name
  697.  
  698.    ≡ The opcion that defines the operation REP2TXT - '/C' can be in either
  699.      capital letter(/C) or in small letter(/c).
  700.    ≡ On TXTDEST if by any reason that file already exits the converted
  701.      messages will be APPENDed to the end of it.
  702.    ≡ To the name of the destiny file(TXTDEST) is allways colocated the 
  703.      extension .MIR for a better recongnize and to avoid possible conflicts 
  704.      with existing files.
  705.  
  706.   ■ The second line opcion is the most powerfull and usefull of the two.
  707.     As the name indicates it converts a normal text file to a REP file ready
  708.     to send to a BBS. 
  709.     - The sintax is:
  710.  
  711.       MAILDB /T TXTSOURCE BBS_ID FROM TO SUBJECT CONFERENCE# [/P]
  712.         ^     ^     ^       ^     ^    ^    ^         ^        ^
  713.         │     │     │       │     │    │    │         │        └ Private Msg.
  714.         │     │     │       │     │    │    │         └ Conference number
  715.         │     │     │       │     │    │    └ Messages subject
  716.         │     │     │       │     │    └ Name of the receiving user [TO]
  717.         │     │     │       │     └ Name of the sending user [FROM]
  718.         │     │     │       └ BBS name. The same name of the downloaded QWK
  719.         │     │     └ Name(and path if necessary) of the file to be converted
  720.         │     └ Command that defines that the opcion TXT2REP is to be executed
  721.         └ Program name
  722.  
  723.    ≡ The fields are all obligatory (exception the last field - private flag)
  724.      this means that they must exists and be on the indicated order. 
  725.      If not, the file will not be well converted.
  726.      This is nothing new to you, in your mail-reader all the fields are 
  727.      obligatory.
  728.      
  729.    ≡ If by any chance it already exists a .REP with the same name, don't 
  730.      worry! It won't be deleted, MailDB will out the new converted messages
  731.      on the end of the existing packet, this is appending the messages to 
  732.      the existing REP. 
  733.      
  734.    ≡ If the file is too big too fit into a single message, it will be cut on
  735.      to several messages with the same caracteristics
  736.      
  737.    ≡ And the file resultant, this is the BBS_ID.REP file is colocated on the 
  738.      REP's upload directory defined in MAILDB.CFG
  739.    
  740.    ≡ When spaces are needed in the introducing of the fields, as for example
  741.      in the field FROM; you want to put 'VITOR SALAS' if you put a '_' on 
  742.      the place of the space, this is 'VITOR_SALAS' the program will 
  743.      correctly recongnize, otherwise not. The rule is simple: Were spaces 
  744.      are needed use a '_'.
  745.      The same is apliable for the TO and SUBJECT fields.
  746.      See the examples in the end of this subject.
  747.      
  748.    ≡ Case don't matter on "/T" opcion.
  749.      
  750.    ≡ "/P" opcion is opcional and is destined to put a message(s) private(s)
  751.      case doesn't matter. It could be "/p" or "/P"
  752.      
  753.    ≡ Maximum size for each field is;
  754.      TXTSOURCE[256], BBS_ID[8], FROM[25], TO[25], SUBJECT[25], CONFERENCE[3]
  755.      The number inside the [] is the maximum number of caracters that the 
  756.      program accepts.
  757.      
  758.    ≡ The maximum file size of TXTSOURCE is 1 MegaByte
  759.  
  760.  ■ Some examples of both line opcions:
  761.    - MAILDB /c BLASTER OLA
  762.       Convert the file BLASTER.REP, that is on REP format to the OLA.MIR file 
  763.       that is a normal text file.
  764.    - MAILDB /C INTRIGA MSGS
  765.       Convert the file INTRIGA.REP, that is on REP format to the MSGS.MIR 
  766.       file that is a normal text file
  767.    - MAILDB /t c:\txt\addit.doc blaster carlos_batista pedro_rosa ola 0 /p
  768.       Convert the file ADDIT.DOC that is on C:\TXT to the BLASTER.REP file
  769.       The messages are are to be sent(in private) by CARLOS BATISTA to PEDRO 
  770.       ROSA in conferece 0(Main Board), and the message subject is OLA.
  771.       The BLASTER.REP is colocated on the upload directory choosen on
  772.       MAILDB.CFG
  773.    - MAILDB /T MAILDB.DOC INTRIGA CARLOS_BATISTA AFONSO_VICENTE A_B_C 1
  774.       Convert the MAILDB.DOC file that is found is the same directory as
  775.       MAILDB.EXE and MAILDB.CFG, to the INTRIGA.REP file where the messages
  776.       are sent by CARLOS BATISTA to AFONSO VICENTE in conference one(1).
  777.       The INTRIGA.REP is colocated on the upload directory defined on
  778.       MAILDB.CFG
  779.  
  780. ------------------------------------------------------------------------------
  781.  
  782. 12- MailDB Log's file (MAILDB.LOG):
  783. ═══════════════════════════════════
  784.  
  785.  ■ MailDB created a file called MAILDB.LOG and that is obvisiouly a LOG file
  786.    What does this mean? Well, it means that in that file you'll encounter
  787.    a register of all the significant operations that you made on MailDB.
  788.  
  789.  ■ The line opcions(TXT2REP and REP2TXT) are not registered.
  790.  
  791.  ■ It's allways present the date and time of the event.
  792.  
  793.  ■ With this file you'll have a way to control your operations on MailDB.
  794.  
  795. ------------------------------------------------------------------------------
  796.  
  797. 13- Errorlevels:
  798. ════════════════
  799.  
  800.  ■ When MailDB encounters some vital error or problem he allways tries to 
  801.    gracefuly exits to DOS, and estabelishes a exit code.
  802.  
  803.  ■ Exit codes to DOS table:
  804.                              
  805.     Exit code:                      Description:
  806.     ----------                      ---------------------
  807.         0                           Normal exit
  808.         1                           MAILDB.CFG not found
  809.         2                           Bad line argument 
  810.         3                           I/O Error
  811.         4                           File too big (on TXT2REP)
  812.        99                           Wrong register code
  813.  
  814. ------------------------------------------------------------------------------
  815.  
  816. 14- Windows(tm) 3.x e o MailDB:
  817. ═══════════════════════════════
  818.  
  819.  ■ With the MAILDB10.ZIP is a file called MAILDB.PIF that is a Program
  820.    Information File to work with Windows(tm) 3.x
  821.    On this file are the information needed by Windows(tm) 3.x to correctly
  822.    execute MailDB over Windows enviromnent.
  823.  
  824.  ■ Also inside MAILDB10.ZIP is a other Windows(tm) file, a .ICO file, that
  825.    is the icon figure to identify MailDB inside Windows(tm).
  826.  
  827.  ■ To put MailDB working under Windows(tm); copy the MAILDB.PIF to the 
  828.    Windows(tm) directory and then enter Windows(tm). And creat a new item 
  829.    using as executable the MAILDB.EXE file, the following operations are 
  830.    easy to understand.
  831.    Then to put the MAILDB.ICO identifying the MailDB program follow the 
  832.    following steps; Highlight the MailDB icon press ALT+ENTER choose 
  833.    'Change Icon' box and then make a browse to found the file MAILDB.ICO 
  834.    in your tree structure and finally when you have found it choose 'OK'.
  835.  
  836.  ■ When you choose the MailDB icon, a argument will be asked, obvsiously is
  837.    as the same format as in DOS, the only difference is that you have to 
  838.    put it in a window and not in a DOS line :)
  839.  
  840.  ■ Intensive tests were made on MailDB working over Windows(tm) and no error
  841.    (as a UAE) was detected. But MailDB was written to a DOS envirnoment and
  842.    not to the Windows(tm), as so, is natural that by any chance a error will 
  843.    occur, but the possibility of that happen is very remote...
  844.  
  845. ------------------------------------------------------------------------------
  846.  
  847. 15- Advices and Tips:
  848. ═════════════════════
  849.  
  850.  ■ Do not creat and maintain modules superiors than, let's say 5000 messages,
  851.    maximum! For a better and optimized consult and a quicker module acess keep
  852.    this in mind.
  853.  
  854.  ■ If by any chance you edit the MIQ file and altered it, keep in mind that 
  855.    some of the functions of the program will be affected! This is because the
  856.    HFS file or message positioning and size information will not be modified
  857.  
  858.  ■ In the menu system, if you want to read the messages destined to you make a 
  859.    string search with your name or to the string PRIVATE for messages only to
  860.    you! 
  861.    Or the messages from Mr.XYZ make a string consult to that string. 
  862.    If you know the message number or the internal number inside MIQ, the 
  863.    better! make a string consult using that number.
  864.  
  865.  ■ If you experience any trouble on opening files please check your CONFIG.SYS
  866.    and AUTOEXEC.BAT file and do one of this things; remove SHARE from 
  867.    AUTOEXEC.BAT or increase the FILES=?? command on CONFIG.SYS.
  868.    In some computers the presence of the SHARE program in memory makes 
  869.    impossible the correct utilization of MailDB, so if you experience any
  870.    troubles on the 'Include QWK' opcion check for SHARE before do anything
  871.    else.
  872.  
  873. ------------------------------------------------------------------------------
  874. 16- Historics:
  875. ══════════════
  876.  
  877.   ■ 0.01ß - First versionäo do MailDB. Only converted QWK2TXT.
  878.   (6/6/92)  It was called MergeIT and it was destined to convert and merge
  879.             QWK packets.
  880.  
  881.   ■ 0.02ß - It started to handle .REP's and it has now a menu.
  882.   (1/7/92)  It changed the name to MailMerge and now it converts QWK and REP
  883.             packets and merge it to two default files: MEREGREP.MI and 
  884.             MERGEQWK.MI.
  885.             First ßeta testers: Fernando Madruga, Duarte Oliveira, 
  886.             Jaime Amaral, Pedro Rosa.
  887.  
  888.   ■ 0.03ß - It started to consult the two files. 
  889.   (19/7/92) A new opcion: Editing the files(removed)
  890.             One more ßeta tester: Joäo Cabral.
  891.  
  892.   ■ 0.04ß - BACKUP/RESTORE opcion. Some alterations on the QWK2TXT convert
  893.   (27/7/92) String consult...
  894.  
  895.   ■ 0.05ß - A LOG file: MMERGE.LOG
  896.   (1/8/92)  Other alterations
  897.  
  898.   ■ 0.06ß - Beta testesting version
  899.   (2/8/92)  First Manual.
  900.  
  901.   ■ 0.07ß - Totally rewrite! Now with a string consult much more efective,
  902.   (15/11/92)directed message consult,export of a message to a text file, DOS
  903.             Shell, BACKUP/RETSORE much quicker, TXT2REP and REP2TXT functions
  904.             REP files are now in line opcions and not in the menu, TWIT-Lists
  905.             colored pull down-menus
  906.             New name: MailDB!
  907.             All major functions were in this version elaborated.
  908.             Two more ßeta testers: Sérgio Duarte and Afonso Vicente
  909.  
  910.   ■ 0.08ß - Version especially designed for beta-testing. Equal to 0.07ß
  911.   (16/11/92)
  912.  
  913.   ■ 1.0α  - Bugs corrected from the previous version.
  914.   (21/12/92)New features:
  915.             - Internal numeracion of the .MIQ
  916.             - F2 (info) function key with more subjects covered
  917.             - Optimazing of Backup/Restore functions and QWK convert function
  918.             - .QWK as a default extension
  919.             - Big alteracions in all consults opcions
  920.             - Comands in viewing the messages
  921.             - Changing module without getting out of the program
  922.             - List of existing modules
  923.             - Etc...
  924.  
  925. ------------------------------------------------------------------------------
  926.  
  927. 17- MailDB Future:
  928. ══════════════════
  929.  
  930.  ■ MailDB will continue to have new versions with new features, such as
  931.    delete of a single message and dupe checking.
  932.  
  933.  ■ But... It is logic that a Offline Mail-Reader will evolute from MailDB, but
  934.    that will only happen if I see that the Shareware as a future as a trust
  935.    and honor concept.
  936.  
  937.  ■ Your register is essencial so that the Shareware in general and MailDB
  938.    in paricular can grow and expand more and more! 
  939.    Your support will make that more good programs like this may be available 
  940.    at such low prices.
  941.  
  942. -------------------------------------------------------------------------------
  943.  
  944. 18- Copyrights:
  945. ═══════════════
  946.  
  947.  ■ SLMR/OLX is copyright of Mustang Software Inc.
  948.  ■ MS-DOS and EDIT are copyright of Microsoft Corporation
  949.  ■ ASCII stands for American Standart Code for Information Interchange
  950.  ■ Turbo C is copyright of Borland Internacional.
  951.  ■ .PIF, .ICO and Windows 3.1 are copyright of Microsoft Corporation
  952.  ■ PKLITE, PKZIP, PKARC and ZIP and ARC are copyright of Phil Katz
  953.  ■ ARJ is copyright of Robert K. Jung.
  954.  ■ LHA, LZH is copyright of Haruyasu Yoshizaki
  955.  ■ PC, XT, AT, PS/2 are copyright of IBM Corp.
  956.  ■ i386 and i486 are copyright of Intel Corp.
  957.  ■ WordStar is copyright of WordStar International Corporation
  958.  
  959. ------------------------------------------------------------------------------
  960.  
  961.  
  962.                                  Carlos Miguel Salas Gonçalves Batista
  963.  
  964.                                         21 of December of 1992
  965.